Skip to content

Restructure AI docs into agentic-coding and vibe-coding#3002

Open
atharvadeosthale wants to merge 4 commits into
mainfrom
cleanup-ai-docs
Open

Restructure AI docs into agentic-coding and vibe-coding#3002
atharvadeosthale wants to merge 4 commits into
mainfrom
cleanup-ai-docs

Conversation

@atharvadeosthale
Copy link
Copy Markdown
Member

  • Split /docs/tooling/ai/ai-dev-tools into /agentic-coding (IDEs + CLI agents) and /vibe-coding (prompt-to-app tools); delete legacy /docs/tooling/mcp section
  • Update all active refs (sidebar, AI overview, marketing, partial, responsible-ai); redirects cover old /mcp/* and /ai-dev-tools/* paths

…coding, drop legacy /docs/tooling/mcp section
@appwrite
Copy link
Copy Markdown

appwrite Bot commented May 18, 2026

Appwrite Website

Project ID: 69d7efb00023389e8d27

Sites (1)
Site Status Logs Preview QR
 website
69d7f2670014e24571ca
Ready Ready View Logs Preview URL QR Code

Website (appwrite/website)

Project ID: 684969cb000a2f6c0a02

Sites (1)
Site Status Logs Preview QR
 website
68496a17000f03d62013
Queued Queued View Logs Preview URL QR Code


Tip

Realtime gives you live updates for users, storage, functions, and databases

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 18, 2026

Greptile Summary

This PR restructures Appwrite's AI tooling docs by renaming the flat /ai-dev-tools/ directory into two sub-sections — /agents/ (IDE/CLI tools) and /vibe-coding/ (prompt-to-app platforms) — and deletes the now-redundant /docs/tooling/mcp/ subtree whose content has been consolidated into the main AI section.

  • All renamed pages receive corresponding redirects.json entries, and all redirect targets were verified to exist at their new locations.
  • Most reference sites (sidebar, AI overview, marketing strip, mcp-add-ides-tools.md partial, responsible-ai) are updated to the new canonical paths; however the docs hub landing page (docs/+page.svelte) was only partially migrated — 7 of its 11 tool card hrefs still point to the deleted /docs/tooling/mcp/* paths and will incur an extra redirect hop.

Confidence Score: 5/5

Safe to merge — all deleted paths are covered by redirects that point to verified destinations, and the content restructure is internally consistent.

The migration is largely complete and correct: every removed URL has a working redirect, all new page files exist, and the primary navigation surfaces (sidebar, overview, marketing) are fully updated. The only gap is the docs hub landing page retaining stale /docs/tooling/mcp/* hrefs for most of its tool cards — these resolve transparently through redirects, so no user-facing breakage occurs.

src/routes/docs/+page.svelte — the ideAiTools and vibeCodingTools arrays have 7 hrefs that weren't updated to the new canonical paths.

Important Files Changed

Filename Overview
src/routes/docs/+page.svelte Only 4 of 11 tool hrefs were migrated to the new canonical paths; the remaining 7 still use /docs/tooling/mcp/* (functional via redirect but inconsistent)
src/redirects.json All deleted /mcp/* and /ai-dev-tools/* paths have correct redirects to new /agents/* and /vibe-coding/* destinations; all redirect targets verified to exist
src/routes/docs/tooling/ai/+layout.svelte Sidebar hrefs updated to new paths; Windsurf is absent from the IDEs section (page exists at /agents/windsurf but has no nav entry)
src/partials/mcp-add-ides-tools.md All card hrefs (including Cursor and Zenflow) updated to new canonical paths in both light and dark blocks
src/routes/(marketing)/(components)/ai.svelte All 6 tool hrefs updated from /ai-dev-tools/* to /agents/*
src/routes/(marketing)/(components)/platforms.svelte Codex and Lovable hrefs updated to new canonical paths
src/routes/docs/tooling/ai/+page.markdoc AI overview page cards updated to new /agents/* and /vibe-coding/* paths in both light and dark blocks
src/routes/docs/tooling/ai/responsible-ai/+page.markdoc Link updated to /docs/tooling/ai/ — already flagged in previous thread that the anchor text names three tools but links to the section root

Reviews (4): Last reviewed commit: "Merge branch 'main' into cleanup-ai-docs" | Re-trigger Greptile

Comment thread src/partials/mcp-add-ides-tools.md Outdated
Comment thread src/partials/mcp-add-ides-tools.md Outdated
Comment thread src/routes/docs/tooling/ai/responsible-ai/+page.markdoc Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant